Window XCreateSimpleWindow(
      Display     *display,
      Window       parent,
      int          x, 
      int          y,
      unsigned int width,
      unsigned int height,
      unsigned int border_width,
      unsigned long border,
      unsigned long background);

arguments

display

Specifies the connection to the X server.

parent

Specifies the parent window.

x, y

Specify the x and y coordinates, which are the top-left outside corner of the window's borders and are relative to the inside of the parent

width, height

Specify the width and height, which are the created window's inside dimensions and do not include the created window's borders window's borders.

border_width

Specifies the width of the created window's border in pixels.

border

Specifies the border pixel value of the window.

background

Specifies the background pixel value of the window.

The XCreateSimpleWindow function creates an unmapped InputOutput subwindow for a specified parent window, returns the window ID of the created window, and causes the X server to generate a CreateNotify event. The created window is placed on top in the stacking order with respect to siblings. Any part of the window that extends outside its parent window is clipped. The border_width for an InputOnly window must be zero, or a BadMatch error results. XCreateSimpleWindow inherits its depth, class, and visual from its parent. All other window attributes, except background and border, have their default values.

XCreateSimpleWindow clears the window when created.

XCreateSimpleWindow can generate BadAlloc, BadMatch, BadValue, and BadWindow errors.

error results

BadAlloc

The server failed to allocate the requested resource or server memory.

BadMatch

The values do not exist for an InputOnly window.

BadMatch

Some argument or pair of arguments has the correct type and range but fails to match in some other way required by the request.

BadValue

Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined by the argument's type is accepted. Any argument defined as a set of alternatives can generate this error.

BadWindow

A value for a Window argument does not name a defined Window.